home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / ffight33.zip / FOODFITE.DOC < prev    next >
Text File  |  1993-03-12  |  46KB  |  1,211 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                     ╥─╖ ╓─╖ ╓─╖ ╥─┐     ╥─╖ ╥ ╓─╖ ╖ ╖ ╓╥╖
  15.                     ╟─  ║ ║ ║ ║ ║ │     ╟─  ║ ║─╥ ╟─╢  ║
  16.                     ╙   ╙─╜ ╙─╜ ╨─┘     ╙   ╨ ╙─╜ ╙ ╙  ╙
  17.                                     DOOR
  18.  
  19.                                  version 3.3
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                               by Michael Wilson
  49.  
  50.                                  The Village
  51.                                 408-229-0706
  52.                         USR Courier HST Dual Standard
  53.                                2400/9600/16.8K
  54.                               24 hours / 7 days
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                 CONTENTS
  61.                                 ════════
  62.  
  63.    I.   Introduction
  64.         a. Overview
  65.         b. Background
  66.         c. Tools
  67.         d. Restrictions in the unregistered version
  68.         e. Benefits of registering
  69.         f. Support
  70.  
  71.    II.  Setup
  72.         a. Supported BBS Systems
  73.         b. Customization of the Game
  74.         c. Configuration File
  75.         d. ITEM.DAT
  76.         e. DEFENSE.DAT
  77.         f. Sample door batch file
  78.         g. Local Mode
  79.         h. Optional Files
  80.         i. Created Bulletins
  81.         j. The Prize Option
  82.         k. Resetting the Game
  83.         l. Better DAT Files
  84.         m. Multi-Node Support
  85.         n. ANSI Screens
  86.  
  87.    III. Use
  88.         a. FFUSER.DOC
  89.         b. Sysop Menu
  90.         c. On-Line Sysop Keys
  91.         d. The Prize option
  92.         e. Resetting the game
  93.  
  94.    IV.  FFMAINT - Nightly Maintenance
  95.  
  96.    V.   FFBULL - Bulletin Generator
  97.  
  98.    VI.  Compufax Software
  99.  
  100.    VII. Registration Information and Form
  101.  
  102.    VIII.Bug report form
  103.  
  104.    IX.  Revision History
  105.  
  106.  
  107.  
  108.  
  109.                               INTRODUCTION
  110.                               ════════════
  111.  
  112. Overview
  113. ────────
  114.  
  115.    FOOD FIGHT is a challenging game that your callers are sure to love.  It
  116.    has few options, so is simple to play and easy to remember.  It is,
  117.    however, rather addicting, so it should become a very popular door.  The
  118.    object is to find money, buy food, and throw it at other players.  When
  119.    these other players log on, they will do the same, and throw food at you.
  120.  
  121.      * Fully configurable - most features can be disabled or
  122.        enabled as desired for your own "custom" game
  123.      * Support for all known and unknown comm ports
  124.      * Fossil driver support
  125.      * Complete monitoring of system time, time left, carrier and DTE
  126.      * Support for color and mono screens
  127.      * Nightly event to delete "aged" players
  128.      * Bulletins that supports ANSI and WC3 color codes listing the
  129.        top ten players in a sorted, single line format
  130.  
  131.  
  132. Background
  133. ──────────
  134.  
  135.    The idea for this door was originally David Clifford's at the Haunted
  136.    Castle BBS (408) 226-1052.  It was inspired by the PIE SPLAT door, and
  137.    since no updates for that door have been seen in years, it was decided to
  138.    write a totally new door with the same concept, yet more colors, options
  139.    and fun.
  140.  
  141.  
  142. Tools
  143. ─────
  144.  
  145.         Language and Compiler:  Borland C 3.1
  146.  
  147.         Editor:                 Multi-Edit 6.10kP
  148.  
  149.         Libraries:              CKit Door Library 2.54
  150.  
  151.         Version Control:        Sage's PVCS
  152.  
  153.         Beta Test:              The Haunted Castle BBS (Wildcat)
  154.                                     209-826-1900
  155.                                 The Village (Wildcat)
  156.                                     408-229-0706/408-229-0709
  157.  
  158.         Tea:                    Earl Grey, Hot (Bigelow)
  159.  
  160.  
  161.  
  162.  
  163. Restrictions in the unregistered version
  164. ────────────────────────────────────────
  165.  
  166.    The game is fully functional in the unregistered state, however, there are
  167.    delays at the beginning and end to remind you to register, and a few
  168.    reminders throughout the program.  They should not be too much of a bother,
  169.    and should give you ample time to test the door before registering.
  170.  
  171.    You may also not change lines 8, 9, 15, 16, 18, 21, 22 and 23 of the
  172.    configuration file.
  173.  
  174.  
  175. Benefits of registering
  176. ───────────────────────
  177.  
  178.    1. All delays and reminders are removed.
  179.  
  180.    2. A 1 year membership in The Village BBS.
  181.  
  182.    3. All future updates FREE, downloaded from The Village BBS.
  183.  
  184.    4. Ability to change lines 8, 9, 15, 16, 18, 21, 22 and 23 in the
  185.       config file.
  186.  
  187.    5. Can list sponsors for the game
  188.  
  189.  
  190.  
  191. Support
  192. ───────
  193.  
  194.    Snail-Mail:  Compufax Consulting Services
  195.                 7145 Aptos Beach Court
  196.                 San Jose, CA  95139
  197.  
  198.    BBS:   The Village
  199.           408-229-0706 or 408-229-0709
  200.           USR Courier HST Dual Standard 16.8k
  201.           Leave comment for the SYSOP in the Main Conference [000]
  202.  
  203.    Voice Mail: 408-496-9045 (24 hours/day)
  204.  
  205.    CompuServe:  76207,1673
  206.  
  207.    Please include all available information including copies of your
  208.    ITEM.DAT, DEFENSE.DAT, FOODFITE.CFG, etc.
  209.  
  210.  
  211.    The latest version will always be available on the following boards:
  212.  
  213.         The Village:
  214.                 408-229-0706 USR Courier HST Dual Standard 16.8
  215.                 408-229-0709 USR Coutier HST v.42bis 14.4
  216.                 Michael Wilson, sysop
  217.  
  218.         The Haunted Castle BBS:
  219.                 209-826-1900 (2 lines with roll-over)
  220.                 USR Courier HST Dual Standard 14.4
  221.                 David Clifford, sysop
  222.  
  223.         CompuServe:  IBM BBS Forum (GO IBMBBS), Doors Library
  224.  
  225.  
  226.  
  227.                                   SETUP
  228.                                   ═════
  229.  
  230. Supported BBS Systems
  231. ─────────────────────
  232.  
  233.    FOODFITE will support any BBS that creates a DOOR.SYS file when
  234.    chaining to a door.  Also, Wildcat 2.x (CALLINFO.BBS), DORINFOx.DEF
  235.    and PC Board - 12.0 through 14.5 (PCBOARD.SYS) are supported.
  236.    The following BBS systems have been tested, and shown to work:
  237.        PCBoard 12.0 through 14.5
  238.        Wildcat! (all versions)
  239.        GAP BBS
  240.        Spitfire 3.0
  241.        RBBS-PC
  242.        QuickBBS
  243.        Remote Access
  244.        MikeBBS (MBBS) v9.9 and above
  245.  
  246.    If your BBS is not on the list, and works, let me know and I'll add it to
  247.    the list.
  248.  
  249.  
  250. Customization of the Game
  251. ─────────────────────────
  252.  
  253.    The following Food Fight Features are fully customizable by you so that
  254.    you can make your own distinct game:
  255.  
  256.    Food Items:  Names, Damage, Cost, Hit Chance (ITEM.DAT)
  257.    Protection Items: Names, Cost, Points, Percent (DEFENSE.DAT)
  258.    Bulletin Locations (FOODFITE.CFG)
  259.    Winning Score (FOODFITE.CFG)
  260.    Losing Score (FOODFITE.CFG)
  261.    Prize: Enable or disable, and what the prize is (FOODFITE.CFG)
  262.    Starting Money: Amount or disable (FOODFITE.CFG)
  263.    Do players get to look for money on their first day? (FOODFITE.CFG)
  264.    Lottery: Tickets per Login, or disable (FOODFITE.CFG)
  265.    Stealing: Enable or Disable (FOODFITE.CFG)
  266.    Bank: Enable or Disable (FOODFITE.CFG)
  267.    Loans: Enable or Disable (FOODFITE.CFG)
  268.  
  269.    I have tried to make Food Fight a "plug and play" type door, but also give
  270.    you the chance to change everything if you want.  So, either play Food
  271.    Fight with the default values, or have some fun, and make some changes.
  272.    Remember that if you make changes that you think are better than the
  273.    defaults, let me know...I might agree.
  274.  
  275.  
  276.  
  277.                              CONFIGURATION FILE
  278.                              ══════════════════
  279.  
  280.    FOODFITE knows what type of system you are using, where to output
  281.    bulletins, Your system name, etc through a configuration file.  The
  282.    configuration file can have any legal DOS filename.  It consists of 15
  283.    lines as follows:
  284.  
  285.    line 1:     c:\door\door.sys
  286.    line 2:     The Village
  287.    line 3:     Michael Wilson
  288.    line 4:     0000000000
  289.    line 5:     ANSI
  290.    line 6:     c:\door\bull\bull99.scr
  291.    line 7:     c:\door\bull\bull99.bbs
  292.   *line 8:     5000
  293.   *line 9:     -5000
  294.    line 10:    Prize line 1
  295.    line 11:    Prize line 2
  296.    line 12:    Prize line 3
  297.    line 13:    Prize line 4
  298.    line 14:    Prize line 5
  299.   *line 15:    20
  300.   *line 16:    YES
  301.    line 17:    NONE
  302.   *line 18:    5
  303.    line 19:    YES
  304.    line 20:    -2
  305.   *line 21:    YES
  306.   *line 22:    5
  307.   *line 23:    YES
  308.  
  309.    *These items cannot be changed in the UNREGISTERED version.
  310.  
  311.    NOTE: The line numbers are only listed for clarity.  Your configuration
  312.    file will have no line numbers listed
  313.  
  314.    LINE 1: This is the complete drive letter, path and filename of your
  315.            BBS door system file.  This can be either DOOR.SYS,
  316.            CALLINFO.BBS or PCBOARD.SYS.
  317.  
  318.    LINE 2: This is the name of your BBS.  It must EXACTLY match the name
  319.            of the BBS you put on the registration form.  Upper and lower
  320.            case make a difference here.  This name will be displayed
  321.            EXACTLY as entered here when the door is registered.
  322.  
  323.    LINE 3: This is the name of the sysop.  This name must EXACTLY match
  324.            the name entered on the registration form.  Upper and lower
  325.            case make a difference.  This name will be displayed as the
  326.            sysop when the door is registered.
  327.  
  328.    LINE 4: The registration number obtained when you register.
  329.  
  330.    LINE 5: This line can have 1 of two values.  Put WILDCAT3 here if you
  331.            are using Wildcat! version 3.x and want your bulletins to use
  332.            the Wildcat! color codes.  Put ANSI here if you want standard
  333.            ansi color codes used in your bulletin.
  334.  
  335.  
  336.  
  337.    LINE 6: This is the complete drive letter, path and filename of your
  338.            COLOR bulletin.  There is no error checking to make sure that
  339.            the path, filename is legal, so make sure you enter the
  340.            information correctly.
  341.  
  342.    LINE 7: This is the complete drive letter, path and filename of your
  343.            MONO bulletin.  This bulletin will not be created if line 5
  344.            contains the keyword WILDCAT3.  However, this line, or a blank
  345.            line, must still be placed here.  There is no error checking to
  346.            make sure that the path, filename is legal, so make sure you
  347.            enter the information correctly.
  348.  
  349.    LINE 8: This is the score that is any player gets a score higher than
  350.            this, they have won the game.  We suggest 750.  Initially, most
  351.            players will have a day or 2 of negative scores, but once they
  352.            get the hang of it, their score should roller-coaster.  If you
  353.            are using the prize option, and the prize is substantial in
  354.            value, then increase this number as desired.  The maximum
  355.            allowed number is 32000.
  356.  
  357.    LINE 9: This is the score that if a player has a score below this, he is
  358.            automatically deleted and started over.  This number should be a
  359.            negative number.  We suggest -5000.   There is usually no return
  360.            from such a low score.  The lowest allowed number is -32000.
  361.  
  362.    LINE 10: These lines describe the prize you are offering.  You may enter
  363.    LINE 11: up to 5 lines of prize description, but each line should not
  364.    LINE 12: exceed 50 characters.  If you wish to disable the prize option,
  365.    LINE 13: enter the word NONE on line 10 and leave lines 11-14 blank.
  366.    LINE 14: Even if your prize description is less than 5 lines, ALL 5 LINES
  367.             MUST BE PRESENT.  Simply leave them blank if not needed.
  368.  
  369.    LINE 15: This is the dollar amount that each player gets when they first
  370.             start the game.  This number must be greater than 0 and less than
  371.             32000.  This number has no dollar sign, no decimal point and no
  372.             commas.
  373.  
  374.    LINE 16: Enter here whether you will allow new players to Look for
  375.             Money on their first day. This line is either YES or NO.  YES
  376.             means that you will allow them to look for money on their first
  377.             day, NO means you will not.
  378.  
  379.    LINE 17: This line of for  non-standard comm port parameters.  If  you do
  380.             not  use  a  standard  comm  port  setup,  then  the  syntax  is
  381.             PORT:AAAA:X where  AAAA is  the base  address and  X is the IRQ.
  382.             FOODFITE  will  also  support  the  use  of FOSSIL drivers.  The
  383.             syntax for a FOSSIL driver is: PORT:F:P. The 'F' tells  FOODFITE
  384.             to  use  a  Fossil  driver  for  it's  communications.   The 'P'
  385.             following  it  tells  it  which  port  to  use  for  the Fossil.
  386.             Example - PORT:F:1,  tells FOODFITE to  use a fossil  driver for
  387.             port 1.  If you use  a standard port setup, place the  word NONE
  388.             here.
  389.             Digiboard Intelligent Async boards are  supported thru the
  390.             Universal DOS driver for Digiboard.  The syntax is the same as
  391.             the Fossil driver except you replace the F with D and give the
  392.             channel number to use.  Example - PORT:D:6 tells FOODFITE that it
  393.             is connected to a Digiboard and to use channel 6 on the
  394.             Digiboard.
  395.  
  396.  
  397.  
  398.    LINE 18: This is the number of lottery tickets a player may buy PER DAY.
  399.             This number defaults to 5, and cannot be changed in the
  400.             unregistered version.  If you wish to totally disable the lottery
  401.             feature, then place a 0 (zero) in this space.  The upper limit is
  402.             32000, which is effectively unlimited.
  403.  
  404.    LINE 19: This option is to enable or disable the Rob Another Player
  405.             on the main menu.  2 options are available:  YES or NO.
  406.             YES will enable Stealing, and NO will disable it.  Anything
  407.             other than YES or NO will default to YES.
  408.  
  409.    LINE 20: This option is the time allowed in the door.  It works this way:
  410.             If the number is ZERO, then no modification is made.  The time
  411.                left on the board is the time allowed inthe door.
  412.  
  413.             If the number is greater than ZERO, and less than the time left
  414.                on the board, the caller is given the new time.
  415.  
  416.             If the number is greater than ZERO, and more than the time left
  417.                on the board, the time allowed in the door is the time left on
  418.                the board.
  419.  
  420.             If the number is LESS than ZERO, then the user will be kicked out
  421.                of the door with this much time left.  This means -5 will
  422.                cause the caller to be returned to the board with 5 minutes
  423.                left.
  424.  
  425.  
  426.    LINE 21: Do you want to offer the ATM bank to your callers.  YES will
  427.             enable the BANK option, NO will disable it.
  428.  
  429.    LINE 22: When players kill themselves, how many days must pass before they
  430.             can play again?  5 is the default.  You can put up to 365 days
  431.             here.  If you place a 0 (zero) here, this will disable the Kill
  432.             Yourself option.  If you are tired of players taking out a loan,
  433.             buying lots of food, throwing it, and killing themselves, then
  434.             coming back in a week and doing the same, make this 365 - that
  435.             way, they cannot play for an entire year!
  436.  
  437.    LINE 23: Do you want to offer the ability for players to take out a loan?
  438.             Put either YES (to enable) or NO (to disable).
  439.  
  440.  
  441.  
  442.                                  ITEM.DAT
  443.                                  ════════
  444.  
  445.    The names of the foods, their cost, damage when thrown and percent
  446.    chance of hitting are all contained in the text file ITEM.DAT.  Each
  447.    line contains 1 food.  There must be exactly 10 foods in the file.  The
  448.    format for each line is:
  449.  
  450.         name,damage,cost,hit chance
  451.  
  452.    NOTE: No spaces around any of the commas.
  453.  
  454.    <name> can be any food name (or any other word), not more than 20
  455.    characters in length.  The name can contain spaces.
  456.  
  457.    <damage> is a number that is the points a thrower gains and the opponent
  458.    loses when a hit occurs.  Remember your "winning score" when you enter
  459.    this number.  Each game should take several weeks to a couple months.
  460.  
  461.    <cost> is a number that is the cost, in dollars, of a single piece of
  462.    this food.  Since the minimum is $20.00 per day, try not to make the
  463.    food too expensive.
  464.  
  465.    <hit chance> is an integer that represents the percentage chance this
  466.    food has of hitting (e.g.: 95 would mean 95% chance of hitting).  The
  467.    higher the number, the greater chance of hitting.  99 is the highest you
  468.    can go.
  469.  
  470.    The ITEM.DAT file that came with this program has been extensively
  471.    tested, and should be fine for most boards.  Be careful, however, when
  472.    altering this file to obey the above rules, and test it prior to letting
  473.    your callers use it.
  474.  
  475.  
  476.  
  477.                                  DEFENSE.DAT
  478.                                  ═══════════
  479.  
  480.    The types of protections offered in your game are listed in DEFENSE.DAT.
  481.    This is a text file that can be edited with any pure ASCII editor.  The
  482.    format is one defense per line in the following format:
  483.  
  484.         type,percent,points,cost
  485.  
  486.    The meaning of each is described below:
  487.  
  488.      TYPE:     This is the type of protection
  489.  
  490.      PERCENT:  This is the percentage of damage that the protection will
  491.                absorb, and deflect away from you.  For example, if someone
  492.                throws a pinapple at you, and hits.  Normally, this would do
  493.                100 points of damage.  But, if you had a Garbage Can Lib, the
  494.                pinapple would only do 50 points of damage (50% of 100).  The
  495.                Garbage can lib would absorb 50 points (50% of 100).
  496.  
  497.      POINTS:   The points is the amount of damage the protection can absorb
  498.                before becoming useless.  In the above example, the garbage
  499.                can can absorb 150 points before becoming useless.  After 3
  500.                hits with a pinapple, absorbing 50 points per hit, the
  501.                Garbage Can Lid would disappear, and you would be without
  502.                protection.
  503.  
  504.    You can have from 0 to 10 protection items.  If you do not wish to enable
  505.    protection in your game, delete DEFENSE.DAT.
  506.  
  507.  
  508.  
  509.  
  510. Sample Door Batch File
  511. ──────────────────────
  512.  
  513.    The configuration filename is placed on the command line of
  514.    FOODFITE.EXE.  Here is a sample batch file to give you an idea of how
  515.    the door is called:
  516.  
  517.           C:
  518.           CD\FOODFITE
  519.           FOODFITE FOODFITE.CFG
  520.           FFBULL FOODFITE.CFG
  521.           CD\
  522.  
  523.    If the configuration file is missing, or incorrectly made, an error
  524.    will be displayed.
  525.  
  526. Local Mode
  527. ──────────
  528.  
  529.    The door can be tested in Local Mode by having the config file point to
  530.    a BBS door file that has a comm port of zero (COM0:).  Included are the
  531.    following files:
  532.  
  533.         LOCAL.BAT
  534.         LOCAL.CFG
  535.         DOOR.SYS
  536.  
  537.    These will assist you in testing the door in local mode.  If you want your
  538.    name displayed instead of "SYSOP", edit DOOR.SYS and replace the word
  539.    SYSOP with your name.
  540.  
  541.    Simply typing LOCAL with the above files in the current directory,
  542.    therefore, will put the door in local mode.
  543.  
  544.  
  545.  
  546.                                OPTIONAL FILES
  547.                                ══════════════
  548.  
  549.    Display Files:
  550.  
  551.       NOTE:  All display files support both ANSI color and Monochrome files.
  552.              You should create both a .SCR and .BBS file for each file name
  553.              (i.e.: SBULL.SCR and SBULL.BBS). The correct file will
  554.              automatically be chosen by FoodFite based on the user's
  555.              "graphics" setting.
  556.  
  557.              All files must be in the same directory as FOODFITE.EXE
  558.  
  559.       SBULL: This file is the Sysop's bulletin.  Callers may view it from the
  560.              main menu.  This file may be of any length, and may give any
  561.              information you want.  Every 23 lines, the display will pause
  562.              and a "more?" prompt will be displayed.  If these files do not
  563.              exist, FoodFite will tell the caller that the bulletin is not
  564.              currently available.
  565.  
  566.       BADUSER: This file is displayed to any caller whose name appears in
  567.                the BADNAMES.LST file.  The default is to tell the caller
  568.                that the door is temporarily closed.  However, if you wish
  569.                to give a more complete explanation, you may create this
  570.                file.  This file can be of any length, and every 23 lines
  571.                the display will pause and a "more?" prompt will be
  572.                displayed.
  573.  
  574.  
  575.  
  576.    Data Files:
  577.  
  578.       PLAYER.DAT:   The complete player list and player statistics. (binary)
  579.  
  580.       BANK.DAT:     All player's bank accounts and information. (binary)
  581.  
  582.       FOODFITE.DAT: Game statistics, displayed with the [D]oor Stats on the
  583.                     sysop menu. (binary)
  584.  
  585.       DEAD.DAT:     This file contains the names and dates players kill
  586.                     themselves.  It is used to determin who is dead, and when
  587.                     they can play again.  Delete it to remove all dead
  588.                     players. (text)
  589.  
  590.       IMESSAGE.DAT: This contains the individual message sent between
  591.                     players. (binary)
  592.  
  593.       GMESSAGE.DAT: This contains the global message left by the last player
  594.                     in food fight.  It will be displayed to the next person
  595.                     to play. (binary)
  596.  
  597.       BATTLE.DAT:   This contains the battle information that is
  598.                     displayed to each player during (not fast) login.
  599.                     (binary)
  600.  
  601.       BADNAMES.LST: This file is a text file that contains 1 name per line.
  602.                     If the caller's name matches a name in this list, they
  603.                     will not be allowed to enter the door.  This is a good
  604.                     tool for people who continue to use nasty or offensive
  605.                     aliases or for people who you don't want playing games
  606.                     on your board. (text)
  607.  
  608.       SPONSOR.DAT:  This file contains the names of the callers who helped
  609.                     sponsor food fight.  The file has 1 name per line, and up
  610.                     to 10 names.  These names will be displayed to the
  611.                     players at the end of the game, IN THE REGISTERED VERSION
  612.                     ONLY! (text)
  613.  
  614.       LASTWIN.DAT:  This file is automatically created when someone wins.  It
  615.                     will be used to tell callers who the last winner was.  If
  616.                     you do not want this information displayed, then delete
  617.                     this file as part of resetting the door after a win.  
  618.                     WildcaT! sysops can also use PostMaster to send this file 
  619.                     to themselves, and alert themselves of a win. (text)
  620.  
  621.       SYSOP.LOG:    This file is created, and logs the activity of players 
  622.                     doing "private" things.  When a player kills themselves, 
  623.                     opens a bank account, deposits or withdrawals from this 
  624.                     account, takes out a loan or pays back a loan, the 
  625.                     information is put here.  The player's real name, alias 
  626.                     name, date/time and activity are logged here.  This is a 
  627.                     straight ASCII file. Since this file can get rather 
  628.                     large, it is up to the sysop to trim this file as needed. 
  629.                     (text)
  630.  
  631.  
  632.  
  633.                              CREATED BULLETINS
  634.                              ═════════════════
  635.  
  636.    Each time you run FFBULL, the bulletins specified in lines 6 and 7 of the
  637.    configuration file are created.  They have a header and a list of the top
  638.    10 players, with the highest score on top.  IF the game has been won, then
  639.    the top player has the word WINNER printed on both sides of his name.
  640.  
  641.  
  642.                              THE PRIZE OPTION
  643.                              ════════════════
  644.  
  645.    The sysop has the option of making FOODFITE a tournament, and offering a
  646.    prize to the winner.   Alter lines 10 through 14 in the config file to
  647.    reflect your desired prize.  Whatever you enter on these lines will be
  648.    displayed to every caller when they enter the door.  It will also be
  649.    displayed to the winner when he wins to remind him of what he has won.
  650.    If you wish to completely disable the prize option, put the word NONE as
  651.    the only word on line 10 in the config file.
  652.  
  653.  
  654.                              RESETTING THE GAME
  655.                              ══════════════════
  656.  
  657.    When someone wins the game, the game will not allow any more players
  658.    into the game.  Anyone entering the game after a win will be presented
  659.    with a notice of the winner, and the time and date of winning.  They
  660.    will also be asked to notify the sysop that the game is over and needs
  661.    to be reset.
  662.  
  663.    When the sysop enters a game that has been won, he will be presented with
  664.    the option of resetting the game, and starting again as the first new
  665.    player.  The sysop may also simply delete PLAYER.DAT, BANK.DAT and
  666.    FOODFITE.DAT.  The next time the door is entered, these files will be
  667.    created, and a new game will begin.
  668.  
  669.    The file FOODFITE.WIN will be created in the foodfite directory when
  670.    someone wins.  It will contain the name of the winner, and the date the
  671.    game was won.  You can put an "if exists foodfite.win" statement in your
  672.    door batch file to watch for this file, and notify you of the need to
  673.    reset the game.
  674.  
  675.  
  676.  
  677.  
  678.  
  679.                               BETTER DAT FILES
  680.                               ════════════════
  681.  
  682.    There are 2 Data files for Food Fight.  ITEM.DAT contains the food
  683.    items for sale.  DEFENSE.DAT contains the protections for sale.
  684.  
  685.    There are sample data files contained in this archive.  These have been
  686.    developed by our beta testers, and work rather well.  We are,
  687.    however, very interested in the data files that you create.
  688.  
  689.    If you have developed your own data files, please upload them to the
  690.    Village BBS (408-229-0706) with a comment to the sysop.  We'll look
  691.    at them, and try them out.  If they work well with our users on the
  692.    West Coast, we'll include them in the next release of FOOD FIGHT, and
  693.    give full credit to your and your BBS.
  694.  
  695.  
  696.  
  697.                              MULTI-NODE SUPPORT
  698.                              ══════════════════
  699.  
  700.    Food Fight does not support true on-line interactive play between two
  701.    callers, but it does support multi-line.  What this means is that 2
  702.    callers may be playing the game at the same time, and all data files,
  703.    display files and scores will be updated on-the-fly so that each player
  704.    will see the changes caused by the other player as it happens.  This may
  705.    seem odd, however, since there is currently no way for one player to be
  706.    aware of another player on the other node(s).
  707.  
  708.    The main setup difference from single to multi-node is the configuration
  709.    file.  Since the first line points to your door information file, you must
  710.    have a different config file for each door information file.  All the
  711.    other lines should remain the same (unless you want to enable the lottery
  712.    on one node and not the other, but why?)
  713.  
  714.    Do whatever you must do to start your multiple nodes, and have a
  715.    different batch file for each Food Fite node.
  716.  
  717.    Food Fight will sense, and use the record locking options bult into SHARE
  718.    from MS DOS 3.30 or later.  If you are using a multi-line system, you
  719.    should load share anyway, but if you have not, it will save you hours of
  720.    trouble if you load it before running Food Fight.  This is because it is
  721.    possible for 2 players to be writing to the PLAYER.DAT, or other data file
  722.    at the same time.  With share loaded, one node will wait until the otehr
  723.    is done.  If share is not loaded, tehy will both write, and corrupt your
  724.    data files.
  725.  
  726.    If retries become necessary, the word "Retry" with the retry number will
  727.    be seen in the upper right hand corner of the screen.  Food Fight will try
  728.    60 retries before existing with a share violation.  Food Fight will NOT
  729.    hang your machine with a Retry, Abort or Fail message if this occurs.  The
  730.    caller will be asked to re-enter the game, which usually clears up any
  731.    SHARE retry loop.
  732.  
  733.    The current node is displayed as part of the sign-on screen.
  734.  
  735.  
  736.  
  737.                                 ANSI Screens
  738.                                 ────────────
  739.  
  740.    With version 2.2, I have started adding in Full Screen ANSI Pictures.  As
  741.    of this release, only 1 has been completed.  It is COP.ANS and will appear
  742.    if a player gets caught trying to steal things from another player.  The
  743.    caller must also have ANSI color enabled.
  744.  
  745.    If you do not want this ANSI picture to be displayed, delete COP.ANS.  If
  746.    Food Fight cannot find that picture, then it will display the old style
  747.    screen.
  748.  
  749.    If you are an ANSI artists, and have some ideas on improving Food Fight
  750.    with Full Screen ANSI Pictures, then call The Village and leave me a
  751.    comment.
  752.  
  753.  
  754.  
  755.                                     USE
  756.                                     ═══
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.                                see FFUSER.DOC
  768.  
  769.  
  770.  
  771.   ┌──────────────────────────────────────────────────────────────────────┐
  772.   │ NOTE:  Make sure that you have FFUSER.DOC available for download by  │
  773.   │ your callers.  It contains complete playing instructions and menu    │
  774.   │ commands.  If your callers have this document, your game will be     │
  775.   │ smoother with fewer questions ask of you about how to play the game. │
  776.   └──────────────────────────────────────────────────────────────────────┘
  777.  
  778.  
  779.  
  780.  
  781.                                  Sysop Menu
  782.                                  ──────────
  783.  
  784.     This option is only available to players with the name SYSOP, or whose
  785.     name matches that name entered in line 3 of the config file.  There are
  786.     4 options on the sysop menu:
  787.  
  788.       RESET THE GAME (Start over):  This will delete all data files and
  789.       players, and start the game over.
  790.  
  791.       DOOR STATS:  This will display a series of stats concerning FOODFITE,
  792.       including, number of uses, last player, last played date and start
  793.       date.  As part of the door stats is bank stats.  Pressing B will
  794.       display the total accounts, top depositor and top borrower.
  795.  
  796.       ZAP A PLAYER: This will permanently remove a player from the game.  He
  797.       can still come back as a new player and start over.  Enter his name in
  798.       the BADNAMES.LST file to prevent him from re-entering the game.
  799.  
  800.       USER LIST: This option will allow you enter the partial ALIAS name of a
  801.       player.  If a match is found, then a detailed display of this player
  802.       will occur.  If you simply press enter for the player's name, then a
  803.       summary of every player in the game will be displayed.  All printing
  804.       will be to device PRN.
  805.  
  806.       BROADCAST A MESSAGE:  You may enter up to 5 lines of message with this
  807.       option.  This message will be shown to every user when they enter the
  808.       game.  It will be shown only once per player.
  809.  
  810.       END A BROADCAST MESSAGE:  This will delete the broadcast message
  811.       created with the above option.
  812.  
  813.       QUIT TO MAIN MENU:  This will return you to the main menu
  814.  
  815.       EXIT TO BBS:  This will exit the door and return you to the BBS.
  816.  
  817.  
  818.  
  819. On-Line Sysop Commands
  820. ──────────────────────
  821.  
  822.    While a caller is on-line, the local sysop has several options.  They are
  823.    as follows:
  824.  
  825.              Function key
  826.              ------------
  827.                 F5              Shell to DOS
  828.                 F8              Return user to system
  829.                 F9              Toggle display on/off
  830.                 F10             Chat mode  (use the ESCAPE key to exit)
  831.               * F3              Toggle printer on/off
  832.               * F4              Toggle pagebell on/off
  833.               * F7              Toggle caller alarm on/off
  834.  
  835.              Alternate key
  836.              -------------
  837.                ALT-H            Toggle between different status lines
  838.  
  839.              * ALT-N            Toggle sysop on next
  840.              * ALT-X            Toggle exit to dos after call
  841.                                 and help lines
  842.  
  843.         Alternately pressing the ALT-H key will bring up
  844.         the next status line screen.  The 1st screen is a help screen,
  845.         the second screen shows your COM port status.
  846.  
  847.  * The function keys marked with an "*"  will only be of use to systems
  848.    using pcboard.sys.  The rest are functional with any system.
  849.  
  850.  
  851.  
  852.                                    FFMAINT
  853.                                    ═══════
  854.  
  855.      FFMaint is a separate program from FOODFITE.EXE.  It should be
  856.      run at least once per week.  Usage is simply this:
  857.  
  858.                 FFMAINT [#] | [LOG=#]
  859.  
  860.      There are two different usage of FFMAINT.  The first is to put a number
  861.      (#) on the command lines.  With this option, FFMaint will open your
  862.      player.dat file, and delete any player that has not played in the number
  863.      of days you specify.
  864.  
  865.      FFMaint displays the number of players kept and the number of players
  866.      deleted.
  867.  
  868.      FFMaint must be run in the directory that contains PLAYER.DAT.
  869.  
  870.      FFMaint will also trim the daily log.  Buy putting the word LOG=# on the
  871.      command line, where # is the number of lines you want to keep, FFMaint
  872.      will trim your news log.  For this option, FFMaint must be run from the
  873.      same directory as DAILY.LOG.  The file DAILY.BAK is created which
  874.      contains the unaltered log.  There can be no spaces on either side of
  875.      the equal sign.
  876.  
  877.      FFmaint will tell you haw many lines it deleted, or if there was no
  878.      deletion needed.
  879.  
  880.      It is a clean and small program that will never make any noise or hang.
  881.      It will, however, return an errorlevel of 1 if something went wrong.
  882.  
  883.  
  884.  
  885.  
  886.                                    FFBULL
  887.                                    ══════
  888.  
  889.    FFBULL is used to create your top ten players bulletins.  It was split out
  890.    from the main FOODFIGHT program with version 2.5.  This was done to make
  891.    Food Fight smaller and faster.  Also, some sysops were asking for the
  892.    ability to only create a top ten bulletin once a night, in their night
  893.    maintenance.
  894.  
  895.    Usage is simple.  Invoke FFBULL with the name of your Food Fight config
  896.    file on the command line.  For example, if your Food Fight config file is
  897.    called FOODFITE.CFG, then do this:
  898.  
  899.         FFBULL FOODFITE.CFG
  900.  
  901.    FFBULL will read the registration information, bulletin color type and
  902.    path/name of your color and mono bulletins, and will create them.
  903.  
  904.    FOODFITE does not create any bulletins during normal operation.  You must
  905.    run FFBULL to create the bulletins.  If you want bulletins that are up to
  906.    the minute, then have your batch file be something like this:
  907.  
  908.         @ECHO OFF
  909.         CD\DOORS\FOODFITE
  910.         FOODFITE FOODFITE.CFG
  911.         FFBULL FOODFITE.CFG
  912.         CD\WC
  913.  
  914.    FFBULL will not include any players who's score is negative.  Only players
  915.    with scores of ZERO or greater will be included in the bulletin.
  916.  
  917.  
  918.  
  919.                               COMPUFAX SOFTWARE
  920.                               ═════════════════
  921.  
  922.    Compufax  Software  is  a  division  of  Compufax  Consulting Services.  We
  923.    specialize in getting the right computer and software for your needs.   All
  924.    of our work is custom and created just for you.
  925.  
  926.    We  started  writing  door  software  with  a program called BUY&SELL Door.
  927.    After reviewing dozens  of For Sale  Doors, we could  not find one  to meet
  928.    our needs,  so we  wrote one.   That is  what we  do.   We find a need, and
  929.    write a door to fill  that.  You won't find  us writing 30 card game  doors
  930.    that all  look the  same.   Each door  is individually  designed to  meet a
  931.    need.  Currently, we have 7 BBS door/Utility Programs programs:
  932.  
  933.         Food Fight
  934.         Buy & Sell
  935.         UNIPAGE
  936.         QDMENU
  937.         Dodge Ball
  938.         Thought of the Day
  939.         ShowMe!
  940.  
  941.    We will not cripple  our doors.  We'll  just put in a  few seconds reminder
  942.    that this copy is unregistered.   We will never write a door  that expires.
  943.    We have  over 60  doors on  our board,  and sometimes  it is month before a
  944.    door is fully tested.  We won't force you to download a demo key every  few
  945.    weeks either.   Everything you  need for  full operation  of our  doors  is
  946.    included in  the distribution  zip.   No runtime  modules, no keys, nothing
  947.    extra, nothing more to download.
  948.  
  949.    All of our doors have a simple to use Local mode.  You can see the  program
  950.    before you put it online.
  951.  
  952.    Your registrations are  forever.  When  we give you  a registration number,
  953.    you will never need to buy anything ever again.  Each new version will  use
  954.    the same number, and you're registered for life.
  955.  
  956.    You can receive  free technical support  even if you  are not a  registered
  957.    user.  Because  of my schedule,  I cannot be  available for voice  support,
  958.    but I'll answer  every message on  my BBS and  Compuserve.  If  you need to
  959.    talk to me voice, I'll be happy to make an appointment and call you.
  960.  
  961.    We're tired of poorly programmed, boring BBS Doors.  We are here to  change
  962.    all that.  We may not have 30 doors, but the few we have are the best!
  963.  
  964.  
  965.  
  966.  
  967.                              MISCELLANEOUS NOTES
  968.                              ═══════════════════
  969.  
  970.     I am doing everything possible to add all the features requested while
  971.     making Food Fight small enough to run on the most minimal BBS system.
  972.     Food Fight is fully tested on my BBS which is Wildcat 3.60Mm running
  973.     under Desqview.  It is also fully tested on The Haunted Castle BBS which
  974.     runs Spitfire.  We make no effort to "pre-release" software.  Everything
  975.     is fully tested for many weeks before final release.
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.                                 REGISTRATION
  994.                                 ════════════
  995.  
  996.      When you register FOODFITE, your registration number will be posted on
  997.      The Village BBS (408-229-0706), in a private message to you.  You
  998.      should allow 1 week from the time you send your check before the
  999.      message is posted.  Other options include sending you the number and
  1000.      sending you the latest version of the program with the number.
  1001.      NOTE: The latest version may not be later than the one you have, and no
  1002.      version number verification will be performed..
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.                         FOOD FIGHT REGISTRATION FORM
  1009.                         ════════════════════════════
  1010.  
  1011.      Your BBS Number (so I can call and play):________________
  1012.  
  1013.  
  1014.      Name: ___________________________________________________
  1015.  
  1016.            (Your name here must match EXACTLY with the name entered
  1017.             on line 3 of the config file.  Upper and lower case make a
  1018.             difference here.  Print or type clearly.)
  1019.  
  1020.  
  1021.      BBS Name: _______________________________________________
  1022.  
  1023.                (Your BBS name here must match EXACTLY with the BBS name
  1024.                entered on line 2 of the config file.  Upper and lower case
  1025.                make a difference here.  Print or type clearly.)
  1026.  
  1027.  
  1028.      The name you have used or wish to use to log into The Village BBS:
  1029.  
  1030.      _________________________________________________________________
  1031.  
  1032.  
  1033.       ╔════════════════════════════════════════════════════════════╗
  1034.       ║                                                            ║
  1035.       ║ If you do not have a login to my board, and wish me to set ║
  1036.       ║ one up for you, supply the following information:          ║
  1037.       ║                                                            ║
  1038.       ║                                                            ║
  1039.       ║ Phone number (with area code): __________________________  ║
  1040.       ║                                                            ║
  1041.       ║ Birthday: _______________________________________________  ║
  1042.       ║                                                            ║
  1043.       ║ Password: _______________________________________________  ║
  1044.       ║                                                            ║
  1045.       ╚════════════════════════════════════════════════════════════╝
  1046.  
  1047.  
  1048.      If you wish me to send you the registration number of the latest
  1049.      version of FOODFITE, fill out the following:
  1050.  
  1051.  
  1052.      Address:____________________________________________________
  1053.  
  1054.              ____________________________________________________
  1055.  
  1056.              ____________________________________________________
  1057.  
  1058.  
  1059.  
  1060.      Mail To:  Compufax Consulting Services
  1061.                7145 Aptos Beach Court
  1062.                San Jose, CA  95139
  1063.  
  1064.      Select which option you would like to register Food Fight:
  1065.  
  1066.  
  1067.      Basic Registration.
  1068.        Includes lifetime registration number posted
  1069.        to The Village BBS in a private message to you....$20.00 _____
  1070.  
  1071.  
  1072.      Mail Number.
  1073.        Includes lifetime registration number mailed
  1074.        to you at the above address.......................$22.50 _____
  1075.  
  1076.  
  1077.      Mail Diskette.
  1078.        Includes lifetime registration number mailed
  1079.        to on a diskette, along with the latest version
  1080.        of this software..................................$27.00 _____
  1081.  
  1082.           Type of diskette: *5.25" High Density _____
  1083.                              5.25" Low Density  _____
  1084.                             *3.5"  High Density _____
  1085.                              3.5"  Low Density  _____
  1086.  
  1087.         *If you choose a High Denisty diskette, you will get
  1088.          sample of other compufax Software on the same disk
  1089.  
  1090.                                            Total Enclosed: __________
  1091.  
  1092.       Payment method:
  1093.  
  1094.       [  ] Check made payable to Compufax Consulting Services.
  1095.  
  1096.       [  ] VISA   [  ] Master Card   [  ] Discover   [  ] Carte Blanche
  1097.  
  1098.       [  ] JCB    [  ] Diner's Club
  1099.  
  1100.  
  1101.     For Credit Card Purchases:
  1102.  
  1103.       Number:________________________________Ex Date:_________________
  1104.  
  1105.       Name on card:___________________________________________________
  1106.  
  1107.       Statement ______________________________________________________
  1108.         Mailing
  1109.         Address:______________________________________________________
  1110.  
  1111.                 ______________________________________________________
  1112.  
  1113.       Home Phone:_____________________ Work Phone:____________________
  1114.  
  1115.  
  1116.       Signature:______________________________________________________
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.                         R E G I S T E R   O N L I N E
  1123.                         ═════════════════════════════
  1124.  
  1125.     You can register this software On-Line on the Village BBS.  From the main
  1126.     menu, Choose [Q]uestionnaires, and choose questionnaire number 6.  Have
  1127.     your charge card ready.
  1128.  
  1129.     We accept VISA, Master Card, Discover, Diner's Club, Carte Blanche and
  1130.     JCB cards.
  1131.  
  1132.     Due to the nature of your purchase, your registration number will be
  1133.     available within 12 hours of you completing the questionnaire.
  1134.  
  1135.  
  1136.     This is how you do it:
  1137.     1. Log onto my board in the normal fashion
  1138.         -If you have never called before, answer the new caller questions
  1139.  
  1140.     2. Press Q from the main menu
  1141.  
  1142.     3. Press 6 and Enter from the Questionaire menu
  1143.  
  1144.     4. Answer the questions
  1145.  
  1146.     5. That's it!
  1147.  
  1148.  
  1149.  
  1150.                                  BUG REPORT
  1151.                                  ══════════
  1152.  
  1153.     Please report any and all bugs to my.  Include as much information as you
  1154.     can.  If I think I have fixed it, I will send you the new version
  1155.     for free, for testing.
  1156.  
  1157.     You may use the form below to report any bugs, or use your own form.
  1158.     Please send the form to me, or upload it to my BBS.
  1159.  
  1160.     Explain the bug:____________________________________________________
  1161.  
  1162.     ____________________________________________________________________
  1163.  
  1164.     ____________________________________________________________________
  1165.  
  1166.     ____________________________________________________________________
  1167.  
  1168.     ____________________________________________________________________
  1169.  
  1170.     ____________________________________________________________________
  1171.  
  1172.     ____________________________________________________________________
  1173.  
  1174.     ____________________________________________________________________
  1175.  
  1176.     ____________________________________________________________________
  1177.  
  1178.     ____________________________________________________________________
  1179.  
  1180.     ____________________________________________________________________
  1181.  
  1182.     ____________________________________________________________________
  1183.  
  1184.     ____________________________________________________________________
  1185.  
  1186.     (use another sheet of paper if needed)
  1187.  
  1188.     Your BBS number:____________________________________________________
  1189.  
  1190.     Version of FoodFite:________________________________________________
  1191.  
  1192.     DOS Date and time of FOODFITE.EXE:__________________________________
  1193.  
  1194.     BBS Software and version:___________________________________________
  1195.  
  1196.     Describe your machine:______________________________________________
  1197.  
  1198.     ____________________________________________________________________
  1199.  
  1200.     Describe your multi-tasking, if any:________________________________
  1201.  
  1202.     ____________________________________________________________________
  1203.  
  1204.     Is this multi-node? (how many)______________________________________
  1205.  
  1206.     Please include copies of your ITEM.DAT, FOODFITE.CFG, FOODFITE.DAT,
  1207.     PLAYER.DAT, IMESSAGE.DAT, GMESSAGE.DAT, DAILY.LOG and your door
  1208.     information file (door.sys, pcboard.sys, callinfo.bbs, etc).
  1209.  
  1210.  
  1211.